Skip to main content

Create a collection

POST Create a collection

Method: POST

URL: https://api.getpostman.com/collections

Description

Creates a collection using the Postman Collection v2 schema format. Include a collection object in the request body that contains the following required properties:

  • info — An object that contains the following properties:

  • name — A string value that contains the collection's name.

  • schema — A string that contains a URL to the collection's schema. For example, the https://schema.getpostman.com/collection/v1 URL.

  • item — An object that contains the HTTP request and response information.

  • request — An object that contains the collection's request information. For a complete list of values, refer to the definitions.request entry in the collection.json schema file. If you pass an empty object for this value, the system defaults to an untitled GET request.

    Note:

  • For a complete list of available property values for this endpoint, use the following references available in the collection.json schema file:

  • info object — Use the definitions.info entry.

  • item object — Use the definitions.items entry.

  • For all other possible values, refer to the collection.json schema file.

Authentication

bearer <token anda>
KeyValue
Content-Typeapplication/json

Params

NamePath
~workspaceworkspaceId

Request Body (Json)

 {
"collection": {
"info": {
"name": "collectionName",
"schema": "collectionSchemaUrl"
},
"item": [
{
"request": {}
}
]
}
}